home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / lib / python2.5 / weakref.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-29  |  13KB  |  441 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.5)
  3.  
  4. '''Weak reference support for Python.
  5.  
  6. This module is an implementation of PEP 205:
  7.  
  8. http://python.sourceforge.net/peps/pep-0205.html
  9. '''
  10. import UserDict
  11. from _weakref import getweakrefcount, getweakrefs, ref, proxy, CallableProxyType, ProxyType, ReferenceType
  12. from exceptions import ReferenceError
  13. ProxyTypes = (ProxyType, CallableProxyType)
  14. __all__ = [
  15.     'ref',
  16.     'proxy',
  17.     'getweakrefcount',
  18.     'getweakrefs',
  19.     'WeakKeyDictionary',
  20.     'ReferenceType',
  21.     'ProxyType',
  22.     'CallableProxyType',
  23.     'ProxyTypes',
  24.     'WeakValueDictionary']
  25.  
  26. class WeakValueDictionary(UserDict.UserDict):
  27.     '''Mapping class that references values weakly.
  28.  
  29.     Entries in the dictionary will be discarded when no strong
  30.     reference to the value exists anymore
  31.     '''
  32.     
  33.     def __init__(self, *args, **kw):
  34.         
  35.         def remove(wr, selfref = ref(self)):
  36.             self = selfref()
  37.             if self is not None:
  38.                 del self.data[wr.key]
  39.             
  40.  
  41.         self._remove = remove
  42.         UserDict.UserDict.__init__(self, *args, **kw)
  43.  
  44.     
  45.     def __getitem__(self, key):
  46.         o = self.data[key]()
  47.         if o is None:
  48.             raise KeyError, key
  49.         else:
  50.             return o
  51.  
  52.     
  53.     def __contains__(self, key):
  54.         
  55.         try:
  56.             o = self.data[key]()
  57.         except KeyError:
  58.             return False
  59.  
  60.         return o is not None
  61.  
  62.     
  63.     def has_key(self, key):
  64.         
  65.         try:
  66.             o = self.data[key]()
  67.         except KeyError:
  68.             return False
  69.  
  70.         return o is not None
  71.  
  72.     
  73.     def __repr__(self):
  74.         return '<WeakValueDictionary at %s>' % id(self)
  75.  
  76.     
  77.     def __setitem__(self, key, value):
  78.         self.data[key] = KeyedRef(value, self._remove, key)
  79.  
  80.     
  81.     def copy(self):
  82.         new = WeakValueDictionary()
  83.         for key, wr in self.data.items():
  84.             o = wr()
  85.             if o is not None:
  86.                 new[key] = o
  87.                 continue
  88.         
  89.         return new
  90.  
  91.     
  92.     def get(self, key, default = None):
  93.         
  94.         try:
  95.             wr = self.data[key]
  96.         except KeyError:
  97.             return default
  98.  
  99.         o = wr()
  100.         if o is None:
  101.             return default
  102.         else:
  103.             return o
  104.  
  105.     
  106.     def items(self):
  107.         L = []
  108.         for key, wr in self.data.items():
  109.             o = wr()
  110.             if o is not None:
  111.                 L.append((key, o))
  112.                 continue
  113.         
  114.         return L
  115.  
  116.     
  117.     def iteritems(self):
  118.         for wr in self.data.itervalues():
  119.             value = wr()
  120.             if value is not None:
  121.                 yield (wr.key, value)
  122.                 continue
  123.         
  124.  
  125.     
  126.     def iterkeys(self):
  127.         return self.data.iterkeys()
  128.  
  129.     
  130.     def __iter__(self):
  131.         return self.data.iterkeys()
  132.  
  133.     
  134.     def itervaluerefs(self):
  135.         """Return an iterator that yields the weak references to the values.
  136.  
  137.         The references are not guaranteed to be 'live' at the time
  138.         they are used, so the result of calling the references needs
  139.         to be checked before being used.  This can be used to avoid
  140.         creating references that will cause the garbage collector to
  141.         keep the values around longer than needed.
  142.  
  143.         """
  144.         return self.data.itervalues()
  145.  
  146.     
  147.     def itervalues(self):
  148.         for wr in self.data.itervalues():
  149.             obj = wr()
  150.             if obj is not None:
  151.                 yield obj
  152.                 continue
  153.         
  154.  
  155.     
  156.     def popitem(self):
  157.         while None:
  158.             (key, wr) = self.data.popitem()
  159.             o = wr()
  160.             if o is not None:
  161.                 return (key, o)
  162.                 continue
  163.             continue
  164.             return None
  165.  
  166.     
  167.     def pop(self, key, *args):
  168.         
  169.         try:
  170.             o = self.data.pop(key)()
  171.         except KeyError:
  172.             if args:
  173.                 return args[0]
  174.             
  175.             raise 
  176.  
  177.         if o is None:
  178.             raise KeyError, key
  179.         else:
  180.             return o
  181.  
  182.     
  183.     def setdefault(self, key, default = None):
  184.         
  185.         try:
  186.             wr = self.data[key]
  187.         except KeyError:
  188.             self.data[key] = KeyedRef(default, self._remove, key)
  189.             return default
  190.  
  191.         return wr()
  192.  
  193.     
  194.     def update(self, dict = None, **kwargs):
  195.         d = self.data
  196.         if dict is not None:
  197.             if not hasattr(dict, 'items'):
  198.                 dict = type({ })(dict)
  199.             
  200.             for key, o in dict.items():
  201.                 d[key] = KeyedRef(o, self._remove, key)
  202.             
  203.         
  204.         if len(kwargs):
  205.             self.update(kwargs)
  206.         
  207.  
  208.     
  209.     def valuerefs(self):
  210.         """Return a list of weak references to the values.
  211.  
  212.         The references are not guaranteed to be 'live' at the time
  213.         they are used, so the result of calling the references needs
  214.         to be checked before being used.  This can be used to avoid
  215.         creating references that will cause the garbage collector to
  216.         keep the values around longer than needed.
  217.  
  218.         """
  219.         return self.data.values()
  220.  
  221.     
  222.     def values(self):
  223.         L = []
  224.         for wr in self.data.values():
  225.             o = wr()
  226.             if o is not None:
  227.                 L.append(o)
  228.                 continue
  229.         
  230.         return L
  231.  
  232.  
  233.  
  234. class KeyedRef(ref):
  235.     """Specialized reference that includes a key corresponding to the value.
  236.  
  237.     This is used in the WeakValueDictionary to avoid having to create
  238.     a function object for each key stored in the mapping.  A shared
  239.     callback object can use the 'key' attribute of a KeyedRef instead
  240.     of getting a reference to the key from an enclosing scope.
  241.  
  242.     """
  243.     __slots__ = ('key',)
  244.     
  245.     def __new__(type, ob, callback, key):
  246.         self = ref.__new__(type, ob, callback)
  247.         self.key = key
  248.         return self
  249.  
  250.     
  251.     def __init__(self, ob, callback, key):
  252.         super(KeyedRef, self).__init__(ob, callback)
  253.  
  254.  
  255.  
  256. class WeakKeyDictionary(UserDict.UserDict):
  257.     ''' Mapping class that references keys weakly.
  258.  
  259.     Entries in the dictionary will be discarded when there is no
  260.     longer a strong reference to the key. This can be used to
  261.     associate additional data with an object owned by other parts of
  262.     an application without adding attributes to those objects. This
  263.     can be especially useful with objects that override attribute
  264.     accesses.
  265.     '''
  266.     
  267.     def __init__(self, dict = None):
  268.         self.data = { }
  269.         
  270.         def remove(k, selfref = ref(self)):
  271.             self = selfref()
  272.             if self is not None:
  273.                 del self.data[k]
  274.             
  275.  
  276.         self._remove = remove
  277.         if dict is not None:
  278.             self.update(dict)
  279.         
  280.  
  281.     
  282.     def __delitem__(self, key):
  283.         del self.data[ref(key)]
  284.  
  285.     
  286.     def __getitem__(self, key):
  287.         return self.data[ref(key)]
  288.  
  289.     
  290.     def __repr__(self):
  291.         return '<WeakKeyDictionary at %s>' % id(self)
  292.  
  293.     
  294.     def __setitem__(self, key, value):
  295.         self.data[ref(key, self._remove)] = value
  296.  
  297.     
  298.     def copy(self):
  299.         new = WeakKeyDictionary()
  300.         for key, value in self.data.items():
  301.             o = key()
  302.             if o is not None:
  303.                 new[o] = value
  304.                 continue
  305.         
  306.         return new
  307.  
  308.     
  309.     def get(self, key, default = None):
  310.         return self.data.get(ref(key), default)
  311.  
  312.     
  313.     def has_key(self, key):
  314.         
  315.         try:
  316.             wr = ref(key)
  317.         except TypeError:
  318.             return 0
  319.  
  320.         return wr in self.data
  321.  
  322.     
  323.     def __contains__(self, key):
  324.         
  325.         try:
  326.             wr = ref(key)
  327.         except TypeError:
  328.             return 0
  329.  
  330.         return wr in self.data
  331.  
  332.     
  333.     def items(self):
  334.         L = []
  335.         for key, value in self.data.items():
  336.             o = key()
  337.             if o is not None:
  338.                 L.append((o, value))
  339.                 continue
  340.         
  341.         return L
  342.  
  343.     
  344.     def iteritems(self):
  345.         for wr, value in self.data.iteritems():
  346.             key = wr()
  347.             if key is not None:
  348.                 yield (key, value)
  349.                 continue
  350.         
  351.  
  352.     
  353.     def iterkeyrefs(self):
  354.         """Return an iterator that yields the weak references to the keys.
  355.  
  356.         The references are not guaranteed to be 'live' at the time
  357.         they are used, so the result of calling the references needs
  358.         to be checked before being used.  This can be used to avoid
  359.         creating references that will cause the garbage collector to
  360.         keep the keys around longer than needed.
  361.  
  362.         """
  363.         return self.data.iterkeys()
  364.  
  365.     
  366.     def iterkeys(self):
  367.         for wr in self.data.iterkeys():
  368.             obj = wr()
  369.             if obj is not None:
  370.                 yield obj
  371.                 continue
  372.         
  373.  
  374.     
  375.     def __iter__(self):
  376.         return self.iterkeys()
  377.  
  378.     
  379.     def itervalues(self):
  380.         return self.data.itervalues()
  381.  
  382.     
  383.     def keyrefs(self):
  384.         """Return a list of weak references to the keys.
  385.  
  386.         The references are not guaranteed to be 'live' at the time
  387.         they are used, so the result of calling the references needs
  388.         to be checked before being used.  This can be used to avoid
  389.         creating references that will cause the garbage collector to
  390.         keep the keys around longer than needed.
  391.  
  392.         """
  393.         return self.data.keys()
  394.  
  395.     
  396.     def keys(self):
  397.         L = []
  398.         for wr in self.data.keys():
  399.             o = wr()
  400.             if o is not None:
  401.                 L.append(o)
  402.                 continue
  403.         
  404.         return L
  405.  
  406.     
  407.     def popitem(self):
  408.         while None:
  409.             (key, value) = self.data.popitem()
  410.             o = key()
  411.             if o is not None:
  412.                 return (o, value)
  413.                 continue
  414.             continue
  415.             return None
  416.  
  417.     
  418.     def pop(self, key, *args):
  419.         return self.data.pop(ref(key), *args)
  420.  
  421.     
  422.     def setdefault(self, key, default = None):
  423.         return self.data.setdefault(ref(key, self._remove), default)
  424.  
  425.     
  426.     def update(self, dict = None, **kwargs):
  427.         d = self.data
  428.         if dict is not None:
  429.             if not hasattr(dict, 'items'):
  430.                 dict = type({ })(dict)
  431.             
  432.             for key, value in dict.items():
  433.                 d[ref(key, self._remove)] = value
  434.             
  435.         
  436.         if len(kwargs):
  437.             self.update(kwargs)
  438.         
  439.  
  440.  
  441.